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1.1 


1.2 


CHAPTER 1 


EDIT-80 Operation 


Introduction 


EDIT-80 is a line-oriented and character-oriented 
text editor. EDIT-80 commands are simple and 
straightforward, yet powerful enough to accommodate 
the most demanding user. For the novice or for 
those requiring only cursory use of EDIT-80, the 
first four chapters of this document contain all 
the information necessary to complete a fairly 
extensive editing session. The remaining chapters 
describe the enhancements to EDIT-80 that provide 
the user with more sophisticated techniques. 


Running EDIT-80 
To run EDIT-80, type and enter 
EDIT 


at TRSDOS command level. EDIT-80 will ask for the 
filename by typing 


FILE: 


Enter the name of your file. Use TRSDOS filename 
format for the filename: 


filename [/extension] [.password] [:drive#] 


If the filename refers to a file that already 
exists, type the filename followed by <enter>, and 
EDIT-80 will read in the file. If the file does 
not have line numbers, EDIT-80 will append them, 
beginning with line number 100 and incrementing by 
100. After EDIT-80 prints 


Version x.x 


copyrig 977,78 (c) by Microsoft 
Created: xxxx 
xxxx_ Bytes free 


it is at commmand level, as indicated by the * 
prompt. All commands to EDIT-80 are entered after 
the * prompt. 


If the filename refers to a new file to be created, 
type the filename followed by the <break> key. 
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EDIT-80 will return the message 


Creating 
Version x.x 


Copyright 1977,78 (c) by Microsoft 


Created: xxxx 


xxxx_ Bytes free 


Next enter the command I (see Section 2.1 for a 
further description of the I command). EDIT-80 
will type the first line number, 00100, followed by 
a tab. 


*I 
00100 


Now you are ready to enter the first line of your 
file. A line consists of up to 255 characters ar” 
is terminated by <enter>. After every ling 
entered, EDIT-80 will type the next line number, 
incrementing by 100. This is the “permanent 
increment." (There are various commands that will 
change the permanent increment - see Chapter 2.) 
Line numbers 00000 through 99999 are available for 
use in your EDIT-80 file. 


NOTE 


Microsoft products such as TRS-80 FORTRAN 
and MACRO-80 all support input files which 
include EDIT-80 line numbers. 


If a typing error is made while entering or editing 
a line, use the Delete key (<—) to delete the 
incorrect character(s). If, while typing a line, 
you wish to erase the entire line and start over, 
type shift <—. 


When you wish to stop entering lines and return to 
command level, type the <break> key after the next 
available line number. 


Ending the Editing Session 
To exit EDIT-80, enter the Exit command: 


*E a *. 
The Exit command writes the edited file to disk 
under the filename that was used to create the 
file. Subsequent editing sessions with that file 
require that a filename be specified with the Exit 
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command. See Section 6.1. 


To exit EDIT-80 without writing the edited file to 
disk, enter the Quit command: 


*Q 


After execution of a Quit command, all the changes 
entered during the editing session are lost. 


1.4 Line Numbers and Ranges 


Most commands to EDIT-80 require a reference to a 
line number or a _ range of line numbers. A line 
number is specified by using the number itself (it 
is not necessary to type the leading zeros), or one 
of three special characters that EDIT-80 recognizes 
as line numbers, These special characters are: 


- (period) refers to the current line 
A (up arrow) refers to the first line 
* (asterisk) refers to the last line 


Ranges may be specified in one of two ways: 
1. With a colon. The designation 
200:1000 


means all lines from line number 200 to_ line 
number 1000, inclusive. If lines 200 and 1000 
do not exist, the range will begin with the 
first line number greater than 200 and end with 
the last line number less than 1000. 


2. With an exclamation point. The designation 
200!3 
means the range of three lines that starts with 
line 200. If line 200 does not exist, 200!3 
means the range of three lines that starts with 
the first line after 200. 


Here are some examples of line and range 
specifications (shown here with the Print command) : 


P.:2000 Prints the range that begins with 
the current line and ends wit! 
line 2000. 

P500 Prints line 500. 


P. Prints the current line. 
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P.115 Prints the range that begins at 
the current line and ends after 
the next 15 lines. 


PA:1500 Prints the range that begins with 
the first line and ends with 
line 1500. 
PA:* Prints the entire file. 
See Appendix C for more examples of range 
specification, 
1.5 Format Notation 


Throughout this document, generalized formats of 
EDIT-80 commands are given to guide the user. 
These formats employ the following conventions: 


1. Items in square brackets are optional. 


2. Items in capital letters must be entered as 
shown. 


3. Items in lower case letters enclosed in angle 
brackets are to be supplied by the user: 


<position> supply any line number (up 
to five digits) or ".","A" 
or "*" 


<range> supply any <position> or 
any <range> 
<range> = <position>:<position> 
or 
<position>!<number> 


<inc> supply a non-zero integer 
to be used as an increment 
between line numbers 


<filename> supply any legal TRSDOS 
filename as described 
in Section 1.2 


4. Punctuation must be included where shown. 


5. Items separated by a vertical line are‘mutually 
exclusive. Choose one. 


6. <break> refers to the break key and is echoed 
as $. If you see a $ in a format notation, it 
refers to the break key. 
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7. +%In any command format, spaces and tabs are 
insignificant, except within a line number or a 
filename. 


8. Underlined items are typed by EDIT-80. 
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CHAPTER 2 


Beginning Interline Editing 


.Editing a file by printing, inserting, deleting and 
replacing entire lines or groups of lines is termed 
interline editing. This section describes the commands used 
to perform these functions. 


2.1 Insert Command 


The Insert command is used to insert lines of text 
into the file. EDIT-80 types each line number for 
you during insert mode. The format of the Insert 
command is: 


I[<position>[,<inc> 7<inc>)] 


Insertion of lines begins at <position> and 
continues until <break> is typed or until the 
available space at that point in the file is 
depleted, (In either case, EDIT-80 returns to 
command level.) s 


If no <inc> is included with the command, the 
default is the permanent increment. ,<inc> 
specifies a new increment that is then established 
as the permanent increment. 3<inc> specifies a 
temporary increment for use with the current 
command, but does not change the permanent 
increment. 


If no argument is supplied with the Insert command 
(I<enter>), insertion resumes where the last insert 
command was terminated, using the last temporary 


increment. If only <position> is supplied 
(I<position><enter>), the permanent increment is 
used. 


EDIT-80 will not allow insertion where a _ line 
already exists. If <position> is a line number 
that already exists, the command I<position> will 
add the permanent increment (or the temporary 
increment, if one was specified) to <position> and 
allow insertion at line number <position>+<inc>. 
If line <position>+<inc> already exists, or if line 
numbers exist between <position> and 
<position>+<inc>, an error message will be printed. 


The line feed ) key may be used to start a new 
physical line without starting a new logical line, 
thus providing compatibility with Microsoft BASIC 
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source files. 


Here is an example using the Insert command: 


*17740,10 

07740 K=K+1 
07750 GO TO 400 
07760 $ 

pets 


Note that the insertion is terminated with <break>. 
The <break> key may be typed at the end of the last 
line inserted (instead of <enter>) or at the 
beginning of the next line. A line is not saved if 
<break> is the first key typed on that line. 


2.2 Delete Command 


The Delete command removes a line or range of lines 
from the file. The format of the command is: 


D<range> 
After a Delete command is executed, the current 
line (".") is set to the first line of the deleted 
range. 
Examples of the Delete Command: 
D7000 delete line 7000 
D. delete the current line 
D200:900 delete lines 200 through 900 
D2000:* delete all-lines from line 
2000 through the last line 
2.3 Replace Command 
The Replace:command combines the effects of the 
Delete and Insert commands. The format of the 
command is: 
R<range>[,<inc> ;<inc>] 
The Replace command deletes all of the “lines in 
<range>, then allows the user to enter new text as 
if an Insert command had been issued. (EDIT-80 
types the line numbers.) 


The options for selecting the increment between 
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line numbers are the same as those for the Insert 
command (see Section 2.1). 


Here is an example using the Replace command: 


*R500:600;50 

0500 DO 80 I=1,7 
00550 ¥ (I) =ALOG (¥ (I) ) 
00600 80 CONTINUE 
— 


In the above example, the lines in the range 500 to 
600 were deleted and replaced by three new lines 
- (500, 550 and 600), using a temporary increment of 
' 50. Insertion terminated automatically because 
5 there was not enough room for EDIT-80 to create 
line 650. 


2.4 Print Command 


The Print command prints lines at the terminal. 
The format of the command is: 


P<range> 
Examples of the Print command: 


P.:700 print all lines from the 
current line through line 700 


P800:* print all lines from line 800 
through the end of the file 


Typing <line feed> ()) at command level will cause 
the line after the current line to be printed. 
Typing <break> at command level will cause the line 
before the current line to be printed. Typing 
P<enter> will cause the next 20 lines to be 
printed. 


2.5 _ List Command 
The List command 
L<range> 


is the same as the Print command, except the output 
goes to the line printer. L 
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2.6 Number Command 


The Number command renumbers lines of text. You 
may wish to renumber lines to "make room" for an 
insertion, or just to organize the line numbers in 
a file. The format of the Number command is 


N[<start>][,<inc> | ;<inc>] [=<range>] 


where: 


1. <start> is the first number of the new 
sequence. If <start> is omitted but <range> is 
included, <start> is set to the first line of 
<range>. If <start> and <range> are omitted, 
but <inc> is included, <start> is set to <inc>. 
If <start> is omitted and <inc> is included and 
<range> specifies only a page number (e.g., 
=/2), <start> is also set to <inc> on that 
page. If <start>, <range> and <inc> are 
omitted, <start> is set to the permanent 
increment. 


2. <inc> is the increment between line numbers in 
the new sequence, The options for selection of 
the increment are the same as those described 
for the Insert command (see Section 2.1). 


3. <range> is the range of line numbers to be 
renumbered. If <range> is omitted, the entire 
file is renumbered. 


If the current line is renumbered, "," is reset to 
the same physical line. 


If a Number command would result in line numbers 
being placed out of sequence, or if EDIT-80 cannot 
fit all the lines using the given increment, an 
"Out of order" error message is returned. 


Due to EDIT-80's internal memory requirements for 
executing a Number command, an attempt to renumber 
a very large file may result in an "Insufficient 
memory" error. If this situation arises, renumber 
a smaller portion of the file, write it to disk, 
renumber another portion, and soon. (See Write 
Command, Section 6.3.) 


Examples of the Number command: 


N7000; 100=200: 1000 Lines 200 through 1000 will 
be renumbered to begin at 
line 7000 and increment by 
100. 
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N,10=400:* 


N9000=10000:* 


N, 100 


N,5=2350!10 


Page 14 


Lines 400 through the end 
will be renumbered to begin 
with 400 and increment by 10. 


Using the permanent increment 
lines 10000 through the end 
will be renumbered to begin 
at 9000. 


Renumber the whole file using 
increment 100. 


This command could be used to 
make room for an insert by 
compactifying the ten lines 
starting with 2350. 
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CHAPTER 3 


Intraline Editing - Alter Mode 


The interline editing commands discussed thus far let you 
edit by inserting, deleting or replacing entire lines. of 
course many editing situations require changes to an 
existing line but not necessarily retyping of the line. 
Editing a line without retyping it is called intraline 
editing, and it is done in Alter mode. 


3,1 Alter Command 


The Alter command is used to enter Alter mode, The 
format of the command is: 


A<range> 


In Alter mode, EDIT-80 types the line number of the 
line to be altered and waits for an Alter mode 
subcommand, 


3.2 Alter Mode Subcommands 


Alter mode subcommands are used to move the cursor; 
search for text; or insert, delete or replace text 
within a line. The subcommands are not echoed on 
the terminal. 


Many of the Alter mode subcommands may be preceded 
by an integer, causing the command to be executed 
that number of times. (When no integer is 
specified, the default is always 1.) In many cases, 
the entire command may ‘also be prefaced with a 
minus sign (-) which changes the normal direction 
of the command's action. For example: 


D deletes the next character 
6D deletes the next 6 characters 
-D deletes the last character 


-12D deletes the last 12 characters 
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Each Alter mode subcommand is described below. A 
summary of the subcommands is given in Appendix B. 


NOTE 


In the following descriptions, $ represents 
<break>, <ch> represents any character, 
<text> represents a string of characters of 
arbitrary length and i represents any 
integer. 


1 


3.3 ' Cursor’ Position 


The following commands or terminal keys are used to 
change the position of the cursor in the line. The 
location of the cursor is called the "current 
position," 


<space> spaces over characters, i<space> moves the 
cursor i characters to the right. 
-i<space> moves the cursor i characters to 
the left. Characters are printed as you 
space over them, 


> moves the cursor to the end of the line. 
If preceded by a minus sign, moves the 
cursor to the beginning of the line. 


L prints the remainder of the line and posi- 
tions the cursor at the beginning of the 
line. Proceed with the next Alter mode 
subcommand, 


P prints the remainder of the line and recy- 
cles the cursor to the current position. 
Proceed with the next Alter mode 
subcommand,. 


Ww moves to the beginning of the next word. A 
word is defined as a contiguous collection 
of letters, numbers, ".", "$", or "$". iW 
advances the cursor over the next i words. 
-iW moves the cursor back through i words 
to the left. 


3.4 Insert Text . 


I inserts text. I<text>$ inserts the given 
text beginning at the current position. 
Note that the text must be followed by a 
<break> or by <enter>. 
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B 


inserts spaces (blanks) at the current 
position, The B command may be preceded 
by an integer to insert that many spaces. 
Spaces are inserted to the right of the 
cursor only. 


inserts characters. iG<ch> inserts i 
copies of <ch>. 


extends a line. The X subcommand types 
the remainder of the line, goes into 
insert mode and lets you insert text at 
the end of the line. The -X subcommand 
moves to the beginning of the line and 
goes into insert mode. (Don't forget to 
end your insertion with <break> or 
<enter>.) 


3.5 Delete Text 


D 


deletes the character at the current posi- 
tion. iD deletes i characters beginning 
at the current position. -iD deletes i 
characters to the left of the current 
position, Deleted characters are 
surrounded by double exclamation points. 


The back-arrow key may also be used to de- 
lete characters. The character 
immediately to the left of the current 
position is deleted, i<back-arrow> is 
equivalent to -iD. 


deletes (hacks) the remainder of the line 
to the right of the cursor (or to the left 
of the cursor if -H is typed) and enters 
the insert mode. Text insertion proceeds 
as if an I command had been typed. 


deletes (kills) characters. K<ch> deletes 
all characters up to but not including 
<ch>. ik<ch> deletes all characters up to 
the ith occurrence of <ch>. -ik<ch> 
deletes all characters up to and including 
the ith previous occurrence of <ch>. If 
<ch> is not found, the command is not 
executed. 
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3.6 


3.7 


deletes (obliterates) text. O<text>$ de- 
letes all text up to but not including the 
next occurrence of <text>. i10<text>$ 
deletes all text up to the ith occurrence 
of <text>. -i0<text>$ deletes all 
characters up to and including the ith 
previous occurrence of <text>. 


deletes (truncates) the remainder of the 
line to the right of the cursor (or to the 
left of the cursor if -T is typed) and 
exits Alter mode. 


deletes (zaps) words. iZ deletes the next 
iwords. -iZ deletes words to the left of 
the cursor. 


Replace Text 


R 


Find Text 


s 


replaces text. iR<text>$ deletes the next 
i characters and replaces them with 
<text>. -iR<text>$ replaces text to the 
left of the cursor. The deleted 
characters are echoed between double 
exclamation points. 


changes characters one character at a 
time. C<ch> changes the next character to 
<ch>. Only the new character is echoed. 
iC may be followed by i characters to 
change that many characters; or it may be 
followed by fewer than i characters and 
terminated with <break>, in which case the 
remaining characters will not be changed. 
-iC does an i<back arrow> and then an iC. 
The i<back arrow> is echoed between 
exclamation points. 


searches for a character. S<ch> searches 
for the next occurrence of <ch> after the 
current position and positions the cursor 
before the character. iS<ch> searches for 
the ith occurrence of <ch>. -S<ch> and 
-iS<ch> search for the (ith) previous 
occurrence of <ch> and position the cursor 
immediately before it. The character at 
the cursor position is not included in the 
search. If <ch> is not found, the command 
is ignored. 
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F finds text. F<text>$ finds the next occur- 
rence of <text> and positions the cursor 
at the beginning of the string. iF<text>$ 
finds the ith occurrence of <text>. 
-F<text>$ and -iF<text>$ find the (ith) 
Previous occurrence of <text> and position 
the cursor before it. 


3.8 Ending and Restarting Alter Mode 
<er> carriage return. Prints the remainder of 


the line, enters the changes and concludes 
altering of that line. 


A same as carriage return. 


E enters the changes and concludes altering 
of that line, but does not print the 
remainder of the line. 


N restores the original line (changes are 
not saved) and either moves to the next 
line (if an A<range> command is still in 
progress), or returns to command level. 


Q restores the original line (changes are 
not saved), exits (quits) Alter mode, and 
returns to command level. 


Shift <— Restores the original line, stays in Alter 
mode and repositions the cursor at the 
beginning of the line. Echoes as AY. 


3.9 Extend Command 


The Extend command is issued at command level and 
is used to extend lines. The format of the command 
is 


X<range> 


The effect of the X command is equivalent to typing 
an A command, followed by an X subcommand. After 
entering an X command, proceed by typing the text 
to be inserted at the end of the line. Don't 
forget you are now in Alter mode and may use any of 
the Alter mode subcommands, once <break> has been 
typed. 


The Extend command is particularly useful for 
placing comments in assembly language programs. 
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CHAPTER 4 


Find and Substitute Commands 


‘ When it is necessary to change a certain portion of text, it 

“is not always immediately known where that text is located 
in the file. Even with a listing of the file on hand, it is 
a tiresome task to scan the listing to find the line number 
of a particular item that must be changed. 


The EDIT-80 Find and Substitute commands allow the user to 
quickly locate text and make necessary changes. 


4.1 Find Command 


The Find command locates a given string of text in 
the file and types the line(s) containing that 
string. The format of the command is: 


F[<range>] [,<limit>] <enter> $<string>$ 


where $ represents the escape key and <limit> is 
the number of lines containing <string> to be 
found. A limit of zero will find all occurrences 
of <string>. The following rules apply to the 
format of the Find command: 


1. If $<string>$ is omitted, the last string given 
in a Find command is used. 


2. If <limit> is omitted and $<string>$ is 
included, <limit> is assumed to be 1. 


3. If <limit> and $<string>$ are omitted, the 
previous limit is assumed. 


4. If <range> is omitted and $<string>$ is 
included, the entire range from the previous 
Find command is used. 


5. If <range> and $<string>$ are omitted, the 
search for the previous string continues from 
the line where the last occurrence was found. 


If the search is unsuccessful, an error message is 
printed. 


Microsoft EDIT-80 User's Guide 


Page 21 


Here is a sample editing session using Find: 


*FA:*$WHI (I) $ 


01100 WHI(I)=0 

*F<enter> 

01400 IF_ (P.GT.WHI (I) )WHI(I)=P 
A. 

01400 . 


*F , 2$WLO (I) $ 

01200 _ WLO(I)=9999 

01500 IF (P.LT.WLO(I))WLO(I)=P 
*A, oo ge ee a 


01500__—«w 


Search fails 


*FSMEAN 
03700 | MEAN=SUM/40 
F, 
04200 IF(P.GT.MEAN) M=M+1 
WRITE (6, MEAN, M 
A420 
04200 —«g 


Find the first line that 
contains WHI(I). Prints line 
1100. Find the next one. Prints 
line 1400. Caught a mistake 

in this line. Alter it. 


Find the first two lines in the 
file that contain WLO(I) (range 
is still .:*). Prints lines 

1200 and 1500. Alter line 1500. 


Find the first line in the file 
that contains AVG. There aren't 
any. Try finding MEAN instead, 
Prints line 3700. 

Find all other lines contain- 
ing MEAN. (Search begins at the 
line after line 3700.) Finds 
two more (4200 and 6700). 

Alter line 4200, etc. 
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4.2 Substitute Command 


The Substitute command locates a given string, 
replaces it with a new string and types the new 
line(s). The format of the command is: 


S[<range>] [,<limit>] <enter> $<old string>$<new string>$ 


where $ represents <break>, and <limit> is the 
number of lines in which <old string> is to be 
replaced by <new string>. A limit of zero will 
replace all occurrences of <old string> with <new 
string>. <new string> may be a null string. The 
following rules apply to the format of the 
Substitute command: 


1. If $<old string>$<new string>$ are omitted, the 
strings given in the last Substitute command 
are used, 


2. If <limit> is omitted and $<old string>$<new 
string>$ are included, <limit> is assumed to be 
zero. 


3. If <limit> and $<old string>$<new string>$ are 
omitted, the previous limit is assumed. 


4, If <range> is omitted and $<old_ string>$<new 
string>$ are included, the entire range from 
the previous Substitute command is used. 


5. If <range> and $<old string>$<new string>$ are 
omitted, substitution continues from where the 
last substitution left off. 


If no occurrence of <old string> is found, an error 
message is printed. 





Example: 
*SA:5000$ALPHA$BETA$ From the first line 
00950 BETA (K) =ABS (1.-LST (K) ) to line 5000, replace 
01750 WRITE(6,400) BETA(K) all occurrences of 





04100 IF_(BETA(K) .LT.0)GOTO 9000 ALPHA with BETA. 
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CHAPTER 5 


Pages 


It is possible to divide an EDIT-80 file into sections 
called pages, which are separated by page marks. The first 
page of a file is always page 1, and EDIT-80 always enters 
command level on page 1 of a multiple-page file. Each 
subsequent page begins with a page mark and is numbered 
sequentially. On any given page, the complete range of line 
numbers (00000 to 99999 or any portion thereof) may be used. 


If EDIT-80 encounters a form feed while reading in a file, 
it will enter a page mark at that point in the file. If 
EDIT-80 encounters a line number that is less than the 
previous line number, it will automatically insert a page 
mark so that proper line number sequence may be maintained. 
When EDIT-80 writes a file out to disk, a form feed is 
output with each page mark. Then, when the file is listed, 
each new page of the file starts on a new physical page. 


5.1 Specifying Page Numbers 


In a single-page file, only a line number is needed 
to indicate <position>. In a multiple-page file, 
EDIT-80 must know the page number as well as_ the 
line number to determine a <position>. That is, 
<position> is indicated by 


<line>[/<page>] 
where 


<line> is ".", "A", "*" or a number of up to five 
digits. ‘ 


<page> is ".", "A", "*" or a number of up to five 
digits. When specifying a page, the characters 
ul", "A" and "*" refer to the current page, the 
first page and the last page, respectively. If 
<page> is omitted, the current page is assumed. 


Consequently, in a multiple-page file a <range>, 
which may be indicated by 


<position>:<position> 
or 
<position>!<number> 


may also contain page numbers. If the page number 
is omitted from the first line number in the range, 
it is assumed to be the current page. If the page 
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number is omitted from the second line number in 
the range, it is assumed to be on the same page as 
the first line number in the range. 


Here are some examples of line numbers and _ ranges 
that include page number specification: 


100/2:*/* Line 100 on page 2 through 
the last line on the last page 
100/2:* Line 100 on page 2 through 
the end of that page 
100:*/5 Line 100 on the current page 
through the last line on 
Page 5 
100/* Line 100 on the last page 
100/.:*/3 Line 100 on the current page 
through the last line on 
page 3 
See Appendix C for more examples of range 
specification. 
Sei2 Inserting Page Marks 


Page marks may be inserted in the file at the 
discretion of the user. To insert a page mark, use 
the Mark command. The format is: 


M<position> 


The page mark is inserted immediately after 
<position>. <position> must exist or an error 
message will be printed. 


The current line reference (".") is retained after 
a Mark command is executed. That is, if <position> 
is before ".", then "." will be moved to the next 
page and will still point to the same physical 
line. 


~Be3 Deleting Page Marks 


Page marks are deleted with the K (Kill) command. 
The format of the command is: : 


K/<page> 


The K command deletes the page mark after <page>. 
For example, in a four-page file, K/2 would delete 
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5.4 


5.5 


the second page mark (the page mark that started 
page 3), and the pages would then be numbered 1, 2, 
and 3. The last line number on <page> must be 
lower than the first line number on <page>+1 before 
a K/<page> command can be executed. 


Begin Command 


Use the Begin command to return to the beginning of 
a page. The format of the Begin command is: 


B[/<page>] 


If <page> is omitted, the B command returns to. the 
beginning of page one. 


Other Commands and Page Marks 


1. A Delete command that crosses over a page 
boundary will delete all lines in the range, 
but will not delete the page mark. 


2. A Print command that moves off the current page 
will print the new page number prior to 
printing the first line specified in the 
command, 


3. When output is being done with the List 
command, a form feed will be printed with each 
page mark, and the page number will be printed 
on each page. 


4. A range specified with an exclamation point may 
cross a page boundary. 


5. If the range specified in a Number command 
crosses page boundaries, numbering will start 
over on each new page; the first line number 
will equal the increment. Consequently, in the 
Number command, <start> and the first line of 
<range> must be on the same page. 
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CHAPTER 6 


Exiting EDIT-80 


Section 1.3 introduced the Exit and Quit commands for 
exiting EDIT-80. These two commands will be described more 


completely in this chapter. An additional command, the 
Write command, will also be presented. 


6.1 Exit Command 


The Exit command is used to write the file to disk 
and return to TRSDOS. The format of the command 
is: 


E[<filename>] [-<switch>] 


The edited file is saved on the disk under 
<filename>. When exiting a new file for the first 
time, <filename> may be omitted. (In which case, 
the opening filename is assigned.) Otherwise, a new 
filename is required for each Exit. The previous 
file serves as a back-up. 


The optional <switch> controls the format of the 
output. (See Section 6.5.) 


6.2 Quit Command 


The Quit command is used to return to TRSDOS 
without writing the edited file to disk. To Quit 
editing, simply enter: 


Q 


After a Quit command, all changes entered during 
the editing session are lost. 


6.3 Write Command 


The Write command writes the edited text to disk 
and then returns to EDIT-80 command level. It does 
not exit the editor, and the current position in 
the file is not changed. The format of the command 
is: 


W[<filename>] [-<switch>] 
A filename is not required in the first Write of a 


new file. A filename is required, however, in all 
subsequent Write and Exit commands. 
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The optional <switch> controls the format of the 
output, (See Section 6.5.) 


6.4 Index Files 


When reading in a file to be edited, EDIT-80 
generates information it needs about each block of 
the disk file. With a small file, this information 
is generated in a few seconds, each time the file 
is read in. However, with larger files (5K or 
more), the time lag required to read in the file 
becomes significant. Thus, when EDIT-80 saves a 
file of 42 or more records on the disk, it also 
saves a small file, separate from the text file, 
containing the required information about the text 
ile. 


This small file is called the index file, and it 
can be read faster than the text file. EDIT-80 
saves the index file under a filename that is the 
same as the text filename (passwords not included), 
with a 2 preceding the first two letters of the 
extension, For example, if the file is called 
FOO/MAC.SAM, the index file is called FOO/ZMA. 


When EDIT-80 is asked to edit a file, it first 
checks for an index file. If an index file exists, 
EDIT-80 reads the index file instead of the text 
file. Care must be taken if the text file is 
modified by another editor or changed and saved in 
BASIC, The user must then delete the index file 
prior to editing the text file again with EDIT-80. 
If the index file is not deleted, EDIT-80 will have 
meaningless information about the text file. 


6.5 Parameters 


When reading in a file, EDIT-80 expects it to be in 
its own representation. If the file appears to be 
in another representation, EDIT-80 will add line 
numbers and try to convert the file to EDIT-80 
standard format. There are, however, several other 
representations that EDIT-80 accepts, if the proper 
switch is appended to the input filename. Switches 
are always preceded by a dash (-): 


filename [/ext] [.password] [:drive#] [-switch] 


For example: FOO/BAS.SAM-BASIC 
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6.5.1 BASIC Switch 


if the BASIC switch is appended to the input 
filename, EDIT-80 will read the file using the 
following algorithm: 


1, All leading spaces and tabs are removed from 
each line, 


2. The first non-blank character must be a digit. 


3, From 1 to 5 leading digits are converted to a 
line number, More than 5 leading digits 
constitutes a fatal error, 


4, A tab is inserted if the first non-digit is not 
a space or a tab. If the first non-digit is a 
space, it is replaced by a tab. If the first 
non-digit is a tab, it is left alone, 


5. On output, if UNSEQ (see Section 6.5.2) has 
been selected, leading zeros in the line number 
are suppressed and the tab is converted to a 
space, 


Because BASIC uses line numbers to control the 
sequence of program execution, BASIC users should 
beware of renumbering with the N command, 
Microsoft BASIC will ignore page marks from the 
EDIT-80 file, so a BASIC file may have multiple 
pages. Insure, however, that no line number 
appears more than once in the program. 


6.5.2 SEQ and UNSEQ Switches 


If the SEQ switch is appended to the input 
filename, EDIT-80 will use the same algorithm to 
interpret the text file as with the BASIC switch. 
However, when the file is output, it will be in 
standard EDIT-80 format, unless the UNSEQ switch is 
appended to the output filename, 


The UNSEQ switch on input tells EDIT-80 to append 
its own line numbers to the incoming file, 
regardless of what it looks like. This switch must 
be used if the incoming file has digits at the 
beginning of lines with high bits on that are not 
to be interpreted as line numbers, 


On output, the UNSEQ switch must be specified (if 
it hasn't been already) to output a non-standard 
file. That is, if BASIC is specified on input and 
UNSEQ is specified on output, the file will be 
output in BASIC format, If BASIC was not specified 
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on input and UNSEQ is specified on output, the file 
will be output with no line numbers and no trailing 
tab. If the UNSEQ switch was specified on input 
and the user wishes to output a standard file, the 


SEQ switch on output will override the UNSEQ 
switch. 
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Command 


Alter 


Begin 


Delete 


Exit 


Find 


Insert 


Kill 


List 


Mark 


Number 


Print 


Quit 


APPENDIX A 


Alphabetic Summary of Commands 


Format and Description 


A<range> 
Enters Alter mode. 


B[<page>] 
Moves to the beginning of <page>. 
Default is page 1. 


D<range> 
Deletes lines. 


E[<filename>] [-<switch] 
Writes the edited text to disk 
and exits the editor. 


F[<range>] [,<limit>] <enter> $<string>$ 


Finds occurrences of <string>. 


I[<position>] [,<inc> 7<inc>] 
Inserts lines beginning at <position> 
using increment <inc>. With no 
argument, continues with previous 
Insert command, 


K/<page> 
Deletes the page mark at the end of 
<page>. 


L<range> 
Prints lines at the line printer. 


M<position> 
Inserts a page mark after <position>. 


N[<start>] [,<ince> ;<inc>] [=<range>] 
Renumbers the lines in <range> so 
they begin at <start> and increment 
by <inc>. 


P[<range>] 

Prints lines at the terminal. 
With no argument, prints the 
next 20 lines. 


Q 
Exits the editor without writing 
the edited text to disk. 
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24 


12 


24 


13 


12 


6, 


26 
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Replace 


Substitute 


Write 


eXtend 


R<range>[,<inc> 7<inc>] 18 
Replaces line(s) using increment 
<inc>. 


S[<range>] [,<limit>]<enter>|$<old string>$<new string>$ 
Replaces <old string> with <new string>. 22 


W[<filename>] [-<switch>] 26 
Writes the edited text to disk but 
does not exit the editor. 


X<range> 19 
Allows insertion of text at the 
end of a line, 


Microsoft EDIT-80 User's Guide 


Command 


A 


io oO AQ wD 
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APPENDIX B 


Alphabetic Summary of Alter Mode Subcommands 


Format 


[i]B 

([-] [i]C<ch>[...<ch>] 
(-] [i]D 

E 


[-] [i] F$<text>$ 
[i] G<ch> 


[-] H<text>$ 


I<text>$ 


(-] [i] K<ch> 


[-] [i]O<text>$ 


Action 
Prints the remainder of the 
line, enters the changes 
and concludes altering of 
that line 
Inserts spaces 
Replaces characters 
Deletes characters 
Enters the changes and 
concludes altering of that 
line 
Finds <text> 
Inserts i copies of <ch> 
Deletes the remainder of 
the line and enters the 
insert mode 
Inserts <text> 


Deletes all characters up 
to <ch> 


Positions the cursor at the 


-beginning of the line 


Restores the original line 
and either moves to the 
next line (if an A<range> 
command is still in 
progress) or returns to 
command level 


Deletes all characters up 
to <text> A 


Recycles the cursor to the 
current position 


Exits Alter mode and 
restores the original line 
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R [-] [i] R<text>$ 
s [-] [i] S<ch> 
4 (-]T 
Ww (-] [ilw 
x [-]x 
zZ (-] [iz 
[-l > 
< 


[-] [i]<space> 


<enter> 


Shift <— 
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Replaces i characters with 
<text> 


Finds <ch> 


Deletes the remainder of 
the line and concludes 
altering of the line 


Moves the cursor over words 
Extends the line 
Deletes words 


Moves the cursor to the end 
of the line 


Deletes characters 


Moves the cursor over 
characters 


Prints the remainder of the 
line, enters changes and 
concludes altering of that 
line 


Restores the original line, 
stays in Alter mode and 
repositions the cursor at 
the beginning of the line, 
Echoes as AY. 
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- The notation 


<line> 
<page> 
<position> 
<range> 
where: 
<number> 


<digit> 


W 


APPENDIX C 


Summary of Notation 


used in this document may be defined as follows: 
<number> | . | A | * 

<number> | . | A | * 

<line>[/<page>] 


<position>[:<position> | !<number>] 


<digit> | <number><digit> 


ofit2[3]falsl[e6][7] es] o9 


Shorthand Notation for Ranges 


The following "shorthand" forms of range specifications may be used 
with EDIT-80 commands. 


Shorthand 
Notation 


/<page> 


Equivalent Range 
To Specified 
A/<page>: */<page> All of <page>. 


/<page1>:/<page2> A/<page1>:*/<page2> The first line on <page1> 


<position>: 


:<position> 


through the last line on 


<page2>. 
A/13*/* The entire file. 
<position>:*/* <position> through the e1 


of the file. e.g., 
-: is the same as ./.:*/' 


A/1:<position> The first line in the fi 
through <position>. e.g. 
:. is the same as A/1:./ 
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APPENDIX D 


EDIT-80 Special Characters 


<break> 


= 


Shift < 


Aborts the command in progress 
and returns to EDIT-80 
command level. 


Types a tab, 


Erases the line being typed 

and lets you start over. 

When used in Alter mode, Shift<-- 
restores the original line, 

stays in Alter mode and 
repositions the cursor at the 
beginning of the line. 


35 


Control characters are typed by holding down the shift 
key, the down-arrow (J) key and the correct alpha 


at the same time. 


Control O 


Control S 


Suspends/resumes output (at 
the terminal or line printer) 
from an EDIT-80 command. 


Halts/resumes execution of 
an EDIT-80 command, 


key 
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APPENDIX E 


Error Messages 


Fatal Errors 


Disk I/O errors are fatal. The corresponding TRSDOS error 
message will be printed. 


Any TRSDOS system error message is fatal. 


Illegal line format 

Occurs when EDIT-80 finds a line with strange contents or a 
strange line number. This should not normally occur when 
editing a file created by EDIT-80. It is usually caused by 
reading files not meant for editing, such as binary files. 


Edit Error Messages 


Illegal command 
Tells the user a nonexistent or ill-formed command was 
typed. 


Insufficient memory available 

Occurs when the user has made enough changes to the file to 
have exhausted EDIT-80's memory area. This should only 
happen when a large file has many changes or when large 
portions of code are being inserted or renumbered. A W 
command should be done to compress memory. 


No string given 

Tells the user the F or S command was given without a search 
string. This usually happens when using the F or S command 
with no arguments prior to issuing an F or S command with 
arguments, or when an <escape> without a search string is 
typed following the range. 


No such line(s) 

This message 1s issued if a command references a line or 
range which does not exist. Usually occurs when the proper 
page number is omitted from the line or range. 


Line too long 

This message is issued when the user attempts to enter a 
line longer than 255 characters. This may happen when the 
line is read or as a result of a command which alters’ the 
line. 7 


Out of order 

Indicates that the line numbers in the file would not be in 
ascending order if the command were to be executed. This 
frequently happens when trying to insert where there is not 
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enough room or trying to delete a page mark. 


Search fails 
An informative message that tells the user a search was 
unsuccessful, 


Wrap around 


This message is printed whenever a line greater than 99999 
would be generated. 


File Errors 


File already exists be 
Issued if the user tries to give the name of an existing 
file to a new file, or tries to rename a file using the name 
of an existing file in an E or W command. 


File not found 
Tssued if the file specified in a command could not be 
found, 


Illegal file specification 
Informs the user that the command string contains an illegal 
character of some kind. 
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APPENDIX F 


Output File Format 


Compilers and assemblers should ignore the line numbers and 
page marks included in EDIT-80 output files (except when 
included in listing files). Microsoft TRS-80 FORTRAN and 
MACRO-80 both do so, 


A line number consists of five decimal digits followed by a 
tab character. All six bytes have the high order bit (bit 
7) equal to one. It is not recommended that EDIT-80 files 
be listed with the TRSDOS LIST command. Graphics characters 
may appear in the line numbers. Use EDIT-80's Print command 
instead. 


When writing a file with -BASIC set, the line numbers have 
the high order bits equal to zero. Each line number is 
followed by a space that has the high order bit equal to 
zero. 


A page mark is a form feed character with the high order bit 
equal to one. 
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Alter 
Alter 
Alter 


command .. 
mode .... 


BASIC 
Begin 


switch... 
command .. 


Command level .. 
Control-O .... 
Control-S .... 


Delete command. . 
Delete key .... 


Error messages . . 
Exit command... 
Extend command. . 


Find command... 
Form feed .... 


Index files ... 
Insert command. . 
Kill command... 
Line 
Line 
List 


feed . 2 oo 
numbers . . « 
command . . e 


Mark command... 


Number command. . 


Page mark ... . 
Page numbers .. . 
Parameters . . « « 
Permanent incremen 
Print command .. 


Quit command... 
Replace command . 


SEQUENCE switch . 
Shift<-- . 2. 2. « « 
Space bar ...-e 
Substitute command 
Switches ....-. 


Tab key . 2 « « « 
TRSDOS . « «we © © 


mode subcommands 


oe eee 


Guide 


Index 


15 
15 
15-19, 32 


28, 
25 


38 


5 
35 
35 


11, 25 
6, 33 


36 
6, 
19 


26 


20 

23, 25, 38 
27 
6, 10 
24 


10, 12 
5-7, 23, 
12, 25 


27, 38 


24 


13, 25, 28 
23-25, 28 
23 
27 
6, 
12, 


13 
38 


10, 
25, 


7, 26 
11 


28 
6, 
16 
22 
27 


19, 33, 35 


16, 
5-6, 


35 


8, 26, 36, 38 
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